home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / CATAGING / DISKCAT.LZH / DC4.DOC < prev    next >
Text File  |  1985-02-26  |  41KB  |  1,050 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                   DISKCAT(tm)
  16.  
  17.                                   version 4.3
  18.  
  19.  
  20.                                   DISK  FILE
  21.                                 CATALOG PROGRAM
  22.  
  23.  
  24.                      (C) Copyright 1983,1984  Nelson Ford
  25.  
  26.  
  27.  
  28.  
  29.                             DISCLAIMER OF WARRANTY
  30.  
  31.    THIS SOFTWARE AND MANUAL ARE SOLD  "AS IS"  AND WITHOUT WARRANTIES AS TO
  32.    PERFORMANCE OF MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER EXPRESSED
  33.    OR IMPLIED.    BECAUSE OF THE VARIOUS HARDWARE AND SOFTWARE ENVIRONMENTS
  34.    INTO WHICH THIS PROGRAM MAY BE PUT, NO WARRANTY OF FITNESS FOR A PARTICU-
  35.    LAR PURPOSE IS OFFERED.
  36.  
  37.    GOOD  DATA PROCESSING PROCEDURE DICTATES  THAT ANY PROGRAM BE THOROUGHLY
  38.    TESTED WITH NON-CRITICAL DATA BEFORE RELYING ON IT. THE USER MUST ASSUME
  39.    THE ENTIRE RISK OF USING THE PROGRAM.   ANY LIABILITY OF THE SELLER WILL
  40.    BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.
  41.  
  42.  
  43.  
  44.  
  45.                                   Nelson Ford
  46.                                  P.O.Box 61565
  47.                                Houston, TX 77208
  48.                                 (713) 960-1347
  49.                              CompuServe: 71355,470
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                       DISKCAT - Disk File Catalog Program
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.                                    CONTENTS
  75.  
  76.  
  77.         Hardware requirements ....................................  1
  78.         What DISKCAT does ........................................  1
  79.         Incompatibilities with earlier versions & other programs .  2
  80.         Entering information .....................................  2
  81.         DC4-READ.EXE Program Functions
  82.           1)  Read a disk's files into the catalog ...............  2
  83.           2)  Add descriptions to file names (DC4-CAT.EXE) .......  3
  84.           3)  Give a disk its own catalog ........................  3
  85.           4)  Delete a disk from the catalog .....................  3
  86.           5)  Display all files for a disk name ..................  3
  87.           6)  Display all disk names .............................  3
  88.           7)  Print a hardcopy catalog listing (DC4-SORT.EXE) ....  3
  89.           8)  Purge deleted files from catalog ...................  3
  90.           9)  Change program parameters ..........................  3
  91.                 Entering printer control codes ...................  3
  92.         DC4-CAT.EXE Program Functions
  93.           1)  Enter file category and description ................  4
  94.           2)  Volume name entries ................................  4
  95.           3)  Subdirectory name entries ..........................  4
  96.           4)  Automatic file descriptions ........................  4
  97.           5)  [Alt]-key commands .................................  4
  98.         DC4-SORT.EXE  Program Functions
  99.           1)  Compare two catalogs ...............................  6
  100.           2)  Print catalog sorted by file name,
  101.               disk name, file type, date or filename extension ...  6
  102.         Sending data to the disk .................................  6
  103.         Specifying a range to print ..............................  6
  104.         Data file structure ......................................  7
  105.  >>>>>  Starting a new catalog ...................................  8
  106.         Suggestions for using DISKCAT.............................  8
  107.         Using DOS 2's FIND.EXE to locate a file in the catalog ...  8
  108.         Assigning categories .....................................  8
  109.         DISTRIBUTION OF DISKCAT PROGRAMS .........................  9
  110.         Source code ..............................................  9
  111.         Acknowledgement of suggestions for improvements .......... 10
  112.         Invoice
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                   DISKCAT - Disk File Catalog Program       Page 1
  134.  
  135.  
  136.         HARDWARE REQUIREMENTS:
  137.  
  138.         Minimum:  128K (192 on Compaq), one disk drive, 80-column monitor.
  139.         Recommended:  a RAM disk-emulator  or  hard disk to hold the data
  140.                       printer, graphics board.
  141.         DOS:  1.0  1.1  2.0  2.1
  142.  
  143.         Maximum # of file name entries:  up to 3000, depending on memory.
  144.  
  145.  
  146.         WHAT DISKCAT DOES:
  147.  
  148.         DISKCAT  keeps track of all of your disk files - no more sticking
  149.            disk after disk into a drive to see if the file you need is on
  150.            it.  It reads 8- or 9-sectored, single- or double-sided disks.
  151.            It will not read fixed disks  or high-capacity drives or other
  152.            non-standard disks.
  153.  
  154.         DC4-READ.EXE  reads a disk's directory, adds file names, date and
  155.            size to a catalog file, gives a disk its own table-of-contents
  156.            file, prints a file listing to keep with each disk,  deletes a
  157.            disk from the catalog file, displays names of all disks in the
  158.            catalog, along with number of sectors and sides and free space
  159.            remaining on each disk, allows changing program parameters.
  160.  
  161.         DC4-CAT.EXE  add file category and description, rename files/disk,
  162.            delete file, view file contents, locate file/disk in catalog.
  163.  
  164.         DC4-SORT.EXE  sorts, prints the catalog file; it will compare two
  165.            catalog files and print a comparative list showing differences
  166.            and matching files; creates new catalog file; prints to screen
  167.            or printer or disk file for later printing; creates data  file
  168.            in a format that can be read by Lotus 1-2-3.  All or part of a
  169.            catalog can be sorted by file name, disk name, file type, date
  170.            or file extension.
  171.  
  172.         DC4-FIND.EXE  is a quick way to search the catalog for a specific
  173.            file to find which disk it is on.
  174.  
  175.         DC4-DOC.EXE  contains an introduction to  DISKCAT  and prints the
  176.            DC4.DOC documentation file to the screen or printer.
  177.  
  178.         DC4-PGM.DTA contains the program parameters:  file names, drives,
  179.            screen colors, printer controls.
  180.  
  181.         DC4-SAMP.DTA and  DC3-SAMP.DT2  are samples of the two data files
  182.            created by DISKCAT.   The first contains the file catalog with
  183.            the following information about each file:   file name,  size,
  184.            creation time and date, file category and description and disk
  185.            name.    The second data file contains the number of disks and
  186.            files in the catalog  and the following information about each
  187.            disk:  disk name, number of sides and sectors, free space, and
  188.            the catalog record number of the disk's first and last files.
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                   DISKCAT - Disk File Catalog Program       Page 2
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.         INCOMPATIBILITIES:
  207.  
  208.            DC4-CAT.EXE  uses keys that may be intercepted by some utility
  209.            programs such as Prokey.   Such programs must be exited before
  210.            using DC4-CAT.EXE, but may be left active with DC4-READ & SORT.
  211.  
  212.            If you have been using a version of  DISKCAT earlier than 3.0,
  213.            you must use the program DC4-CNVT.BAS to convert DC4.DTA's re-
  214.            cord format to the current format.   The current format has a
  215.            36-character description field, increased from 25 characters.
  216.            You may keep the names of your data files if you wish by using
  217.            the  "Modify program parameters" option in  DC4-READ to change
  218.            the default data file name.
  219.  
  220.  
  221.         ENTERING INFORMATION:  When entering data, the edit keys work the
  222.           same way that they do in BASIC and in most word processors:
  223.  
  224.            CURSOR keys
  225.              -left & right move the cursor within the data field.
  226.              -up & down moves to fields above or below current field.
  227.  
  228.            CTRL + CURSOR left or right
  229.              -moves one word if cursor is within a field or
  230.              -moves to adjoining fields if cursor is at either end
  231.                 of the current field.
  232.  
  233.            ENTER causes all characters displayed in the field to be
  234.               accepted as input, regardless of cursor location.
  235.  
  236.            INS toggles the Insert function on and off.
  237.  
  238.            DEL deletes the character at the cursor position.
  239.  
  240.            HOME moves the cursor to the beginning of the field.
  241.  
  242.            END moves the cursor to the end of the field.
  243.  
  244.            CTRL + END deletes to the end of the field.
  245.  
  246.           Entering a character at the start of a field automatically
  247.           deletes the  rest of the field  so that a new entry can be
  248.           made.   To add  characters to the front  of displayed text
  249.           without deleting existing text,  toggle the Insert mode on
  250.           first. You may have to delete characters first to make room.
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                   DISKCAT - Disk File Catalog Program       Page 3
  266.  
  267.  
  268.  
  269.  
  270.         DC4-READ.EXE Program Functions (Main Menu):
  271.  
  272.         1)  Read a disk's files into the catalog.
  273.              -prompts for a name for the disk.   If the disk has a volume
  274.                label, it is made the default disk name.  When asked for a
  275.                disk name, press Enter to use the default name.
  276.              -checks to see if name is already used.  If so, choices are
  277.               * delete the disk from the file
  278.               * read the disk and update the file
  279.                 This option allows you to update a disk's records without
  280.                 wiping out the file descriptions for files that are still
  281.                 on the disk.  If a file has the same name but a different
  282.                 file size or date, the name, category and description are
  283.                 retained and the size and date are updated.
  284.               * enter another disk name
  285.              -file names, size  & date are read from disk, sorted by name
  286.                and added to the data file with the "DTA" extension.   The
  287.                disk name,  disk type (number of sides & sectors) and free
  288.                space remaining are added to the data file with the  "DT2"
  289.                extension.
  290.  
  291.         2)  Add descriptions to file names. (See DC4-CAT)
  292.  
  293.         3)  Give a disk its own catalog.
  294.              -puts a directory listing on a  disk with file descriptions.
  295.                The file can be TYPEd from DOS to review contents of disk.
  296.                If you gave the volume name a description, it is displayed
  297.                in the heading of the listing along with the disk name.
  298.  
  299.         4)  Delete a disk from the catalog.
  300.              -removes all files from the catalog that belong to the  disk
  301.                that is being deleted.
  302.  
  303.         5)  Display all files for a disk name.
  304.              -allows a list to be made of file names and descriptions for
  305.                a disk.  The printout can be inserted into the disk sleeve
  306.                for reference.
  307.  
  308.         6)  Display all disk names.
  309.              -also displays number of sectors and sides and free space.
  310.  
  311.         7)  Print a hardcopy catalog listing.
  312.              -goes to the DC4-SORT program to print a catalog file.
  313.                (DC4-SORT is discussed in detail later.)
  314.  
  315.         8)  Purge deleted files from catalog.
  316.              -eliminates records that have been marked for deletion.
  317.               NOTE: compressing records in  a random access file does not
  318.                change the file size in the directory.  To change the file
  319.                size, copy DC4.DTA in DOS using /A which will cause DOS to
  320.                stop at the EOF marker.  (See COPY in DOS manual.)
  321.              -the catalog should be purged before creating a new file via
  322.                DC4-SORT.
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                   DISKCAT - Disk File Catalog Program       Page 4
  332.  
  333.  
  334.  
  335.         9)  Change program parameters.
  336.              -allows you to change the names of the DISKCAT  programs and
  337.                data files to suit your taste.  You can use this option to
  338.                change catalogs if you have more than one catalog file.
  339.              -change default drives and screen colors.
  340.              -put in printer commands for your printer.  Example:  To put
  341.                the Epson/IBM printer into compressed print, you must send
  342.                the printer an ASCII 15. From BASIC, to put the Epson into
  343.                compressed print you would type LPRINT CHR$(15). So in the
  344.                DC4-READ program, enter the print control code as CHR$(15).
  345.                Press Alt-E or Alt-I or Alt-O to get the control codes for
  346.                Epson, IDS, or Okidata printers, respectively. Others must
  347.                be entered manually as described. See your printer manual.
  348.  
  349.  
  350.         DC4-CAT.EXE  Program Functions:
  351.  
  352.          1)   Displays the disk name and file name  and prompts for a 10-
  353.                character file category and 36-character file description.
  354.                The categories displayed at the top  of the screen  can be
  355.                entered into the category field by entering  the number or
  356.                highlighted characters of the desired category name.
  357.  
  358.          2)   DOS 2 volume labels are automatically given a category name
  359.                of "Vol. Name" so that all disk  names will print out in a
  360.                group when the file is sorted and printed by category.  In
  361.                the description field enter a description of disk contents.
  362.  
  363.          3)   DOS 2 subdirectory names are automatically given a category
  364.                name of "Subdir.".
  365.  
  366.          4)   The following is a list of filename extensions and their de-
  367.                fault descriptions which automatically appear. Press Enter
  368.                to accept a default description or enter a new description.
  369.  
  370.                     EXTENSION               DEFAULT DESCRIPTION
  371.                  ----------------   ------------------------------------
  372.                  EXAMPLE.ASM        Assm. source code for EXAMPLE.EXE
  373.                  EXAMPLE.DOC        Documentation file for EXAMPLE
  374.                  EXAMPLE.DTA/.DAT   Data file for EXAMPLE
  375.                  EXAMPLE.HEX        EXAMPLE in hex format for downloading
  376.                  EXAMPLE.OBJ        File used to generate EXAMPLE.EXE
  377.                  EXAMPLE.VC         VisiCalc template to ...
  378.                  EXAMPLE.WKS/.PRN   123 template to ...
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                   DISKCAT - Disk File Catalog Program       Page 5
  398.  
  399.  
  400.  
  401.          5)   Several commands are available to make entering descriptions
  402.               easier and quicker. The commands are displayed at the bottom
  403.               of the screen.  They are executed by holding the Alt key and
  404.               pressing the appropriate key.  The key to press is indicated
  405.               by being highlighted and capitalized on the screen.  It will
  406.               be the same key as is shown in brackets in the following:
  407.  
  408.          [P] Prior entry: displays previous entry.
  409.  
  410.          [F] Find file:  finds a file from all  or part of the name  and
  411.                            makes it the current record.
  412.  
  413.          [D] Find disk:  finds a disk from all or part of the name,  and
  414.                            makes the first file on the disk the  current
  415.                            record.   Optionally, skips files in the data
  416.                            file not on the selected disk. The reason for
  417.                            this option is  that when a disk is  updated,
  418.                            new files on the disk are added to the end of
  419.                            the catalog.   As a result, all the files for
  420.                            a disk  will no longer be grouped together in
  421.                            the catalog.   This option allows you to work
  422.                            on the files for just one specific disk.
  423.  
  424.          [K] Kill file:  marks  the displayed entry  for deletion by the
  425.                            "Purge" routine.   Also allows the file to be
  426.                            deleted from the disk.
  427.  
  428.          [V] View file: displays contents of a file one screen at a time,
  429.                            to aid in entering file descriptions.  If the
  430.                            file is not an ASCII file, the display may be
  431.                            meaningless, unless it is a BASIC program, in
  432.                            which case it will be translated to ASCII.
  433.  
  434.          [R] Repeat entry: repeats category  & description from previous
  435.                            file:  for programs with multiple files, such
  436.                            as FK.DOC, FK.HEX, FK.COM.  Also see [F1-F10].
  437.  
  438.          [S] Skip disk: finds the next disk name and makes its first file
  439.                            the current record.
  440.  
  441.          [C] Edit categories:  allows you to change the category names.
  442.                            The names will be sorted and re-displayed when
  443.                            you are through making changes.
  444.  
  445.          [N] Rename disk/file:   (1) Change the name of a disk throughout
  446.                            the catalog file.     (2) Rename a file in the
  447.                            catalog file and on the disk.
  448.  
  449.          [B] Find Blank description:   finds the next file in the catalog
  450.                            with a blank description field.
  451.  
  452.          [M] Manual entry:   Allows a manual entry to be made for non-DOS
  453.                            disks, such as Flight Simulator.
  454.  
  455.  
  456.  
  457.          (continued)
  458.  
  459.  
  460.  
  461.  
  462.  
  463.                   DISKCAT - Disk File Catalog Program       Page 6
  464.  
  465.  
  466.  
  467.  
  468.         (DC4-CAT.EXE  Program Functions, continued:)
  469.  
  470.  
  471.          [F1-F10] Memorize/recall a category and description:
  472.  
  473.          IF THE FUNCTION KEY DOES NOT HAVE ANYTHING ASSIGNED TO IT:
  474.  
  475.               -The next category and description entered will be assigned
  476.                  to the function key pressed.
  477.               -If the current file already has a category and description
  478.                  that you want assigned to the Fkey, press Enter twice.
  479.               -Otherwise, enter a category and description or press [Esc]
  480.                  to abort.
  481.               -The Fkey number and first six characters of the description
  482.                  will be displayed at the bottom of the screen.
  483.  
  484.          IF THE FUNCTION KEY ALREADY HAS A CATEGORY AND DESCRIPTION:
  485.  
  486.               -They will become the prompts for the current file.
  487.               -Press Enter twice to accept the prompts or press [Alt] and
  488.                  a different function key to recall different prompts.
  489.               -Or press [Esc] to clear the function key. The program will
  490.                  then be ready to assign new text to the Fkey.  If you do
  491.                  not want to set up this function key, press [Esc] again.
  492.  
  493.  
  494.  
  495.         DC4-SORT.EXE  Program Functions:
  496.  
  497.         1)  Compare two catalogs.
  498.              -compares two catalogs and prints a comparative list.   This
  499.                function is designed to facilitate comparing software lib-
  500.                raries by different user groups or individuals who collect
  501.                public domain software.
  502.  
  503.         2)  Print catalog sorted by file name, disk name, file type, date
  504.              or filename extension.
  505.  
  506.         Print Options:
  507.  
  508.         1)  Output can be sent to the screen, the printer, or to a disk.
  509.  
  510.         2)  When the data in the sorted field, such as disk name, changes,
  511.             you may choose to skip two lines on the printout, skip to the
  512.             top of the next page, or not skip at all.
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                   DISKCAT - Disk File Catalog Program       Page 7
  530.  
  531.  
  532.  
  533.         3)  Data sent to a disk file can be formatted in three ways:
  534.              -the same as the printout (to dump to a printer later.)
  535.              -as a LOTUS 1-2-3 ".PRN" file (to be loaded into 1-2-3.)
  536.              -as a new catalog file.    When a disk is first read, all of
  537.                its files are grouped together. When a disk in the catalog
  538.                is re-read and the catalog updated, new files are added to
  539.                the end of the catalog.  Then when the catalog is searched
  540.                for the files of a particular disk the program must search
  541.                longer.   By sorting the catalog by disk name and creating
  542.                a new catalog file,  you can cut down on disk search time.
  543.                After creating  the new file,  you must purge it using the
  544.                DC4-READ menu selection 8.  Purging causes the record num-
  545.                ber for the first and last record for each disk to be calc-
  546.                ulated and stored for faster record retrieval.
  547.  
  548.         4)  You may specify a range to print.  Examples:
  549.              -to print file names starting with  A through  M, enter A as
  550.                the starting parameter and M as the ending one. If you get
  551.                the message  "Out of string space" when trying to load and
  552.                print the entire catalog, you may have to use use this op-
  553.                tion to print one part of the catalog at a time.
  554.              -to print all files with the category of "BASIC Util", first
  555.                select "Sort by category" then specify "BASIC Util" as the
  556.                starting and ending parameters.
  557.  
  558.         DATA FILES:
  559.  
  560.         1)  DC4-PGM.DTA contains the program parameters.   This file must
  561.              always be present to run DISKCAT.   (The information in this
  562.              file used to be included in DC#.NFO with the disk data.)
  563.  
  564.         2)  ***.DTA is a random access file containing file names & info.
  565.             The name of this file on the distribution disk is DC4-SAMP.DTA
  566.             but can be changed to any legal file name by menu selection 9
  567.             in the DC4-READ program.
  568.               Record layout:
  569.                 file name        12 spaces
  570.                 disk name         8 spaces
  571.                 file type        10 spaces
  572.                 file descrip.    36 spaces
  573.                 file date         8 spaces
  574.                 file size         6 spaces
  575.                 car. rtn./l.f.    2 spaces  (carriage return & line feed)
  576.                                  --
  577.                 record length    82
  578.  
  579.         3)  ***.DT2 is a sequential file containing disk names & info. as
  580.               well as the number of files and disks in the catalog.  This
  581.               file is name DC4-SAMP.DT2 on the distribution disk.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                   DISKCAT - Disk File Catalog Program       Page 8
  596.  
  597.  
  598.  
  599.  
  600.         STARTING A NEW CATALOG:
  601.  
  602.         When you receive DISKCAT it is set to read the DC4-SAMP files. To
  603.         create your own catalog file, run  DC4-READ  and edit the program
  604.         parameters. Change DC4-SAMP to whatever you like and respond  "Y"
  605.         when asked  "Make the changes permanent?"   The program will look
  606.         for whatever filename you entered on whatever drive you specified
  607.         and, not finding it, will ask you what drive it is on. Just press
  608.         the Esc key, as directed, and the file will be created.
  609.  
  610.  
  611.         SUGGESTIONS FOR USING DISKCAT:
  612.  
  613.         As already mentioned,  this program makes it easy for user groups
  614.         to catalog  and describe  their public  domain software libraries
  615.         and to compare them with other groups.  Because disks can be read
  616.         so quickly,  libraries of up to  3000  files each can be read and
  617.         compared in a matter of minutes.
  618.  
  619.         People who have a hard disk that is backed up on floppy disks will
  620.         find that by keeping the  catalog file on the hard disk,  you can
  621.         use DOS 2's FIND.EXE or  DC4-FIND to find in seconds which disk a
  622.         file is backed up on.
  623.  
  624.         Those without a hard disk may find it handy to have a printout of
  625.         the catalog sorted by filename for reference at times  when it is
  626.         not convenient to load DISKCAT.
  627.  
  628.         Some people are using  Diskcat exclusively for keeping an index of
  629.         word processing text files.   They change the category captions to
  630.         suit their needs and give each entry a description. Since such text
  631.         files can accumulate and get out of control quickly, this is a good
  632.         way to be able to find a particular letter long after you have writ-
  633.         ten it.
  634.  
  635.         USING DOS 2's FIND.EXE ("FIND")-
  636.  
  637.         FIND  will search for a string of  characters anywhere in a file.
  638.         You may prefer to use FIND instead of DC4-FIND.EXE  to search the
  639.         catalog. To use it to display all files of a particular category,
  640.         such as "DOS Util", enter the following:  FIND "DOS Util" DC4.DTA
  641.         Notice that  upper case and  lower case must be correct to find a
  642.         match. Also, the file extension must be right-justified:  to find
  643.         the file, TEST.BAS, you must specify  "TEST    .BAS".
  644.         A batch file to make  FIND  a little easier to use can be created
  645.         by typing in the following at the DOS prompt:
  646.         COPY CON: F.BAT
  647.         FIND "%1" DC4.DTA
  648.         (press F6 to get a ^Z)
  649.         With this batch file, you can just enter F  and the characters in
  650.         the file that you want to locate.
  651.  
  652.         To use DC4-FIND.EXE, at the A> prompt, enter DC4-FIND.   You will
  653.         be prompted for all or part of a file name to search for.
  654.  
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.                   DISKCAT - Disk File Catalog Program       Page 9
  662.  
  663.  
  664.         ASSIGNING CATEGORIES-
  665.  
  666.         The Category is meant to be a "key field" that you can use to get
  667.         similar file to print out together. Let's say you are classifying
  668.         the DISKCAT programs.  For Category, you could call DC4-CAT.EXE a
  669.         "Disk catalog"  file, the  .DOC  file a "Documentation" file, the
  670.         .DTA file a "Data file".    But when you sort by Category, do you
  671.         want to see all the  documentation files listed by themselves and
  672.         all the data files by themselves?    You might prefer to classify
  673.         all related files the same as the main program, so that they will
  674.         be grouped together when printing a list sorted by Category.
  675.  
  676.         If you use the Categories displayed at the top of the screen, you
  677.         will be assured that file categories that you want  to match will
  678.         match exactly so that they will print out together.   To edit the
  679.         Categories, press Alt-C in the "Add Descriptions" program, as de-
  680.         cribed earlier.
  681.  
  682.         DISTRIBUTION OF DISKCAT PROGRAMS-
  683.  
  684.         A limited license is granted to copy the COMPILED versions of the
  685.         DISKCAT version 4.3 programs and the associated files under the
  686.         following conditions:
  687.  
  688.         1. Copying is for the sole purpose of allowing potential buyers
  689.            of the program an opportunity to try out DISKCAT before paying
  690.            for it.
  691.  
  692.         2. The BASIC source code should not be needed for such an evalua-
  693.            tion, therefore, it may not be copied or distributed.
  694.  
  695.         3. All copyright notices must be left intact.
  696.  
  697.         4. All the files on the distribution disk, including the invoice
  698.            file must be offered together as a complete set.
  699.  
  700.         5. NO FEE MAY BE CHARGED FOR PROVIDING ANYONE WITH COPIES OF THE
  701.            DISKCAT FILES NOR MAY COPIES BE GIVEN AWAY AS PART OF ANY TYPE
  702.            OF COMMERCIAL ENDEAVOR, SUCH AS, BUT NOT LIMITED TO, SOFTWARE
  703.            PROMOTIONAL GIVE-AWAYS BY VENDORS WITHOUT THE EXPRESS WRITTEN
  704.            CONSENT OF THE AUTHOR.  WRITE FOR MORE INFORMATION.
  705.  
  706.         Since there is no way for me to control the continued distribution
  707.         of outdated copies of  DISKCAT, users should be aware that changes
  708.         in the program, the price or in the terms of distribution may have
  709.         occurred since this document was written.
  710.  
  711.         SOURCE CODE-
  712.  
  713.         Registered users may get the source code for DISKCAT by sending
  714.         a DSDD formatted disk, ppd. mailer plus $50. The source code for
  715.         DISKCAT may NOT be copied and distributed.  If you make changes
  716.         or have suggestions for improvements I am interested in hearing
  717.         of them,  but no modified versions of DISKCAT may be copied and
  718.         distributed,  since I have no way to help other users when they
  719.         have problems with the modified versions.
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.                   DISKCAT - Disk File Catalog Program       Page 10
  728.  
  729.         Acknowledgements for Suggestions:
  730.  
  731.         (1) Kill file from disk when deleting entry from DISKCAT.
  732.         (2) Show free space on disk along with file name.
  733.             (James Jacques    Delafield,WI)
  734.  
  735.         (3) Show disk type (# sectors and # sides) along with file name.
  736.             (Bob Duval   Charleston, SC)
  737.  
  738.         (4) Include DC4.HDR file for easier use with PC-FILE.
  739.         (5) Read DOS 2.0 subdirectories (possible future enhancement.
  740.             I would first like to know if many people are using
  741.             subdirectories on floppies.)
  742.             (John Burns    Mattawan, MI)
  743.  
  744.         (6) Several people have suggested a routine to print a disk
  745.             directory on a label to be attached to the disk.  The reasons
  746.             that this has not been done yet are (1) the idea of this
  747.             program is to make it easy to locate files using the DC4-FIND
  748.             program or a sorted list printed out, (2) disk contents
  749.             change easily, disk labels change less easily, and (3) there
  750.             are several programs in the public domain already that print
  751.             such labels.  Another problem is squeezing 112 files onto a
  752.             label that will fit on the disk.  One company has solved this
  753.             by using the subscript character set for the Epson printer.
  754.             What do people without Epsons do?
  755.  
  756.             As a substitute, option 6 at the main menu [Display All Files
  757.             for a Disk] will let you print out a list to be inserted into
  758.             the disk's sleeve.  This routine prints the name and descrip-
  759.             tion of all the files in two columns.  To get the printout to
  760.             fit into a diskette sleeve, you need to set your printer to
  761.             compressed print (15+ char. per inch) by setting the printer
  762.             switches or entering the control codes in the DC4-READ program.
  763.  
  764.         (7) Put time and date on catalog listings.
  765.         (8) Sort the disk names.
  766.         (9) When sorting and printing the catalog, insert blank lines or
  767.             a form feed when the sorted field changes.
  768.             (George Margolin     Newport Beach, CA)
  769.  
  770.        (10) Allow a file to be renamed from within program.
  771.        (11) Allow a disk to be renamed in the catalog file.
  772.             (John Markley      Homer, LA)
  773.  
  774.        (12) Allow screen colors to be changed from within the program.
  775.             (Mike Hawkins    whereabouts unknown)
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.                   DISKCAT - Disk File Catalog Program       Page 11
  794.  
  795.  
  796.        (13) Allow the user to enter a range to print in DC4-SORT.
  797.        (14) Make the disk's volume name the default disk name.
  798.        (15) Allow the user to assign a volume name from DC4-CAT.
  799.        (16) Add routine to read files on hard disk.
  800.        (17) Add some color.
  801.        (18) In printouts, place size and date fields adjacent to file
  802.               name for easier reading.
  803.        (19) Read the disk name from the (DOS 2) volume label.
  804.             Other people have suggested reading the volume label from the
  805.             directory to use for the disk name, but it seemed like more
  806.             trouble that it was worth.  But Michael Roland also has a
  807.             very clever idea for using the volume names.  Michael came up
  808.             with the idea of giving each disk's volume name (which is
  809.             read along with the other file names from the directory) the
  810.             same category so that all of the disks' volume names will be
  811.             grouped together when the file is printed by DC4-SORT sorted
  812.             by category.  Now why didn't I think of that?  He also
  813.             suggests using the "Add descriptions" routine to add a
  814.             description of disk contents to the volume name entry.
  815.             (Michael B. Roland   Dammam, Saudi Arabia)
  816.  
  817.        (20) Speed up the sort 600-900%.
  818.        (21) Put time and date on comparative printout and mark matching
  819.             files to make them easier to spot.
  820.        (22) Show on the printout which field the file was sorted on.
  821.        (23) Add an option to allow printing the data file sorted by date.
  822.        (24) Make it easier to delete a disk from the file.
  823.        (25) Change the symbol for a deleted record from "z" to "/" to be
  824.             compatible with PC-FILE.
  825.             (Pete Smothers,  President, New Orleans PC User Group)
  826.             Pete backed up his suggestions with BASIC code.  Using the
  827.             sort routine he provided, a sort that took 5 minutes 15
  828.             seconds with the routine I was using now takes 7 seconds!
  829.             The first time I tried it, I thought that it had kicked out
  830.             of the routine without sorting.  Boy was I surprised!
  831.             Thanks, Pete.
  832.    4.0
  833.        (26) SPLIT "ADD CATEGORIES" INTO ITS OWN PROGRAM.  I fought this
  834.             as long as possible, wanting to keep the speed of having as
  835.             many functions as possible in one program, but kept running
  836.             out of room in the main program.  The new feature that pushed
  837.             it over the limit this time was keeping track of each file's
  838.             first and last record number in the data base.  When you have
  839.             a large data base, this will greatly speed up functions that
  840.             search for all files for a particular disk.
  841.        (27) Allow program parameters to be changed from within the program.
  842.             I have always been annoyed at not being able to look at two
  843.             different catalog files on my hard disk without moving or
  844.             renaming them.  Now this is possible.
  845.             (Me,      Houston, Texas)
  846.  
  847.        (29) Make the documentation easier to read and make it easier to
  848.             start a new catalog.
  849.             (George Margolin     Newport Beach, CA)
  850.    4.1
  851.        (30) Added the routines to allow the entry and use of printer
  852.             control codes.
  853.        (31) Added routines to allow temporarily assigning file categories
  854.             and descriptions to function keys to be recalled and assigned
  855.             to other file names.
  856.  
  857.  
  858.  
  859.                   DISKCAT - Disk File Catalog Program       Page 12
  860.  
  861.  
  862.              Changes to DC4-CAT:
  863.    4.2  (32) Routine to allow manual entries for non-DOS disks.
  864.         (33) Routine to View BASIC programs not saved in ASCII.
  865.         (34) Fixed bug that hung up system when end of file reached while
  866.              adding descriptions under the option that skips all files not
  867.              on a specified disk. (whew!) (reported by Jim Layfield)
  868.         (36) Replaced code (stolen by gremlins) that saves changes made to
  869.              categories.
  870.  
  871.         (37) Added routine to display NumLock and CapsLock status.
  872.  
  873.         (38) Fixed bug in DC4-READ that truncated right digit of file size
  874.              if over 99,999.
  875.         (39) Fixed bug in DC4-SORT that kept printout from starting a new
  876.              page when a change in the sorted field occurred.
  877.              (Thanks to my chief bug-finder: Dwight Espensen, who has long
  878.              been keeping me honest.)
  879.         (40) Removed the data file name DC4.DTA from DC4-FIND.EXE.
  880.         (41) Added option to DC4-SORT to pause at each page to change paper.
  881.              (Suggested by David Romer, Toronto, Ontario, Canada, who also
  882.              provided enough info to allow me to track down another elusive
  883.              bug that follows:)
  884.         (42) Fixed bug that deleted the last file name for a disk if it did
  885.              not have a volume label.
  886.  
  887.    4.3  (43) Fixed several minor problems and one major one in DC4-SORT that
  888.              caused the same file name to be repeated when printing to disk,
  889.              and another that caused sorted printouts to be inconsistent.
  890.  
  891.    DISKCAT 5.0, when completed, will allow reading subdirectories. With this
  892.    version, the disk name field will be expanded to 11 characters to be com-
  893.    patible with the actual volume name on the disk. Path names and other en-
  894.    hancements will be added. DISKCAT 5.0 may be distributed through regular
  895.    commercial channels. If so, registered users of earlier versions will be
  896.    able to upgrade at regular upgrade cost.
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925. -
  926. 1350
  927.  
  928.             -------------------------------------------------------
  929.             * * * * * * * * * *  I N V O I C E  * * * * * * * * * *
  930.             -------------------------------------------------------
  931.  
  932.  
  933.  
  934.                                  D I S K C A T
  935.  
  936.                                      4 . 3
  937.  
  938.  
  939.                           Please make check payable to:
  940.  
  941.                                   Nelson Ford
  942.                                  P.O.Box 61565
  943.                                Houston, TX 77208
  944.                                 (713) 960-1347
  945.  
  946.  
  947.  
  948.  
  949.  
  950.          Date: _____________
  951.  
  952.          Name: _________________________________
  953.  
  954.          Address: ______________________________
  955.  
  956.                   ______________________________
  957.  
  958.  
  959.  
  960.          Where did you get your copy of Diskcat?
  961.  
  962.          _______________________________________________________________
  963.  
  964.  
  965.                                             Qty.    Price       Total
  966.                                             ---     -----     ----------
  967.  
  968.         DISKCAT Disk File Catalog Program   ___  @ $39.95     $_________
  969.  
  970.         Source Code                         ___  @  50.00      _________
  971.  
  972.         Total                                                 $_________
  973.  
  974.         Sales Tax for Texas Residents                          _________
  975.  
  976.                                                               $_________
  977.  
  978.  
  979.  
  980.  
  981.  
  982.         Thank you for your order.
  983.  
  984.  
  985.  
  986.  
  987.  
  988.  
  989.  
  990.  
  991. -
  992.                    DISKCAT DISTRIBUTION LICENSING AGREEMENT
  993.  
  994.  
  995.     Anyone wishing to charge people a fee for giving them a copy of Disk-
  996.     cat must have the written authorization of the author, without which,
  997.     the distributor is guilty of copyright violation.    To receive such
  998.     authorization, send this completed application, along with a copy of
  999.     your software library's order form to:   Nelson Ford,  P.O.Box 61565,
  1000.     Houston, TX 77208.    Include $7 to cover the cost of processing the
  1001.     application and of sending you the latest version of Diskcat.   (Fee
  1002.     may be waived for non-profit, non-mail-order user groups.)
  1003.  
  1004.          Name of Organization: ____________________________________
  1005.  
  1006.          Your Name: _______________________________________________
  1007.  
  1008.          Address:   _______________________________________________
  1009.  
  1010.                     _______________________________________________
  1011.  
  1012.  
  1013.          TERMS OF DISTRIBUTION OF DISKCAT:
  1014.  
  1015.          1. The fee charged may not exceed $7, including postage,
  1016.             mailer and any other charges.  If Diskcat is shipped
  1017.             along with other disks, the $7 limit includes the
  1018.             charge for the disk plus a pro-rata share of the total
  1019.             shipping and handling and other charges.
  1020.  
  1021.          2. Your library's catalog or listing must state that this
  1022.             program is not free, but is copyrighted software that is
  1023.             provided to allow the user to evaluate it before paying.
  1024.  
  1025.          3. The label on the disk should show that this is a demo
  1026.             program for which payment is expected on acceptance for
  1027.             use. Labels will be furnished on request.
  1028.  
  1029.          4. The offering and sale of Diskcat will be stopped at any
  1030.             time the author so requests.
  1031.  
  1032.          5. Copies must be made from the copy of Diskcat sent to you
  1033.             with this agreement. This is required for control purposes.
  1034.  
  1035.          6. Problems or complaints will be reported to the author for
  1036.             resolution.
  1037.  
  1038.          In return for the right to charge a fee for the distribution of
  1039.          the program Diskcat, I agree to comply with the above terms of
  1040.          distribution.
  1041.  
  1042.          Signed,
  1043.  
  1044.          ______________________________________    ______________
  1045.                   your signature                        date
  1046.  
  1047.  
  1048.          __________________________   _________    ______________
  1049.                 Nelson Ford           control #         date
  1050.